home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 2 / CU Amiga Magazine's Super CD-ROM 02 (1996)(EMAP Images)(GB)[!][issue 1996-04].iso / magazine / amiga_e / epp / readme_first.doc < prev   
Text File  |  1980-01-05  |  3KB  |  80 lines
  1. ============================================================================
  2.  
  3.                          EPP V1.4d - E Preprocessor.
  4.            Copyright ©1993-1994 Barry Wills.  All rights reserved.
  5.  
  6.  
  7. ============================================================================
  8.  
  9.  
  10. GETTING STARTED.
  11. ~~~~~~~~~~~~~~~
  12. The directories in this archive have roughly the same structure as the
  13. original E V2.1b distribution.
  14.  
  15. See E/Docs/EPP.doc for copyright notice, a full description of what EPP is,
  16. and instructions on how to use EPP.
  17.  
  18. How to use the examples (CLI only):
  19.  
  20.     1.  Copy archive contents into the corresponding directories in which
  21.         you have installed E.
  22.     2.  CD to the E directory.
  23.     3.  Make the following DOS assignments:
  24.  
  25.         PATH bin add  ;EC must be in your path.
  26.         ASSIGN PMODULES: PModules
  27.  
  28.     4.  Example 1:
  29.  
  30.         a.  CD to the directory E/Sources/Examples/EPP_Example1.  Type:
  31.  
  32.             EPP mod0 ;This produces the E source program temp_main.e,
  33.                      ; compiles it, and renames the executable to mod0
  34.  
  35.         b.  The program mod0 can now be run (although it will not do
  36.             anything.)  You may have noticed that E echos EC's notifica-
  37.             tion of the existence of unused identifiers (well, okay, all
  38.             the identifiers in this example are unused.)  This example uses
  39.             empty E structures in modules nested 5 deep to demonstrate what
  40.             EPP can do.
  41.  
  42.         c.  You can run EPP in verbose mode by supplying the "-v" switch on
  43.             the command line.  This will show the progress of module
  44.             inclusion.
  45.  
  46.         d.  You can save the final source output by supplying the "-s"
  47.             switch on the command line.  Then you can compare the original
  48.             and final sources to get a feel for what is happening.  For a
  49.             more readable final output, use the "-c" switch to tell EPP to
  50.             put informative comments in the final output source.  You can
  51.             name the final output file by specifying its name on the
  52.             command line, otherwise EPP uses temp_main.e as the default.
  53.  
  54.     5.  Example 2:
  55.  
  56.         a.  CD to the directory E/Sources/Examples/EPP_Example2.
  57.  
  58.         b.  Type:
  59.  
  60.             EPP args_test
  61.               ;This produces the E source program temp_main.e,
  62.               ; compiles it, and renames the executable to args_test
  63.  
  64.         c.  The program main can now be run.  This example uses some real
  65.             modules.  It accepts command-line arguments and displays the
  66.             values.  Run it without arguments first to find out the usage.
  67.             Then play with the arguments until you get a feel for what is
  68.             happening.
  69.  
  70.         d.  Return to step b for each of the tests in the EPP_Example2
  71.             directory.
  72.  
  73. EPP is very simple to use.  The examples provided should be adequate to
  74. demostrate how to use EPP, but there are additional features which are
  75. immediately evident.  Read EPP/Docs/EPP.doc for additional details and
  76. hints, the copyright notice, and credits to others.
  77.  
  78.  
  79. ============================================================================
  80.